---
title: PostgreSQL
description: Verbindung zur PostgreSQL-Datenbank herstellen
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="postgresql"
  color="#336791"
  icon={true}
  iconSvg={`<svg className="block-icon"
      
      
      
      viewBox='-4 0 264 264'
      xmlns='http://www.w3.org/2000/svg'
      preserveAspectRatio='xMinYMin meet'
    >
      <path d='M255.008 158.086c-1.535-4.649-5.556-7.887-10.756-8.664-2.452-.366-5.26-.21-8.583.475-5.792 1.195-10.089 1.65-13.225 1.738 11.837-19.985 21.462-42.775 27.003-64.228 8.96-34.689 4.172-50.492-1.423-57.64C233.217 10.847 211.614.683 185.552.372c-13.903-.17-26.108 2.575-32.475 4.549-5.928-1.046-12.302-1.63-18.99-1.738-12.537-.2-23.614 2.533-33.079 8.15-5.24-1.772-13.65-4.27-23.362-5.864-22.842-3.75-41.252-.828-54.718 8.685C6.622 25.672-.937 45.684.461 73.634c.444 8.874 5.408 35.874 13.224 61.48 4.492 14.718 9.282 26.94 14.237 36.33 7.027 13.315 14.546 21.156 22.987 23.972 4.731 1.576 13.327 2.68 22.368-4.85 1.146 1.388 2.675 2.767 4.704 4.048 2.577 1.625 5.728 2.953 8.875 3.74 11.341 2.835 21.964 2.126 31.027-1.848.056 1.612.099 3.152.135 4.482.06 2.157.12 4.272.199 6.25.537 13.374 1.447 23.773 4.143 31.049.148.4.347 1.01.557 1.657 1.345 4.118 3.594 11.012 9.316 16.411 5.925 5.593 13.092 7.308 19.656 7.308 3.292 0 6.433-.432 9.188-1.022 9.82-2.105 20.973-5.311 29.041-16.799 7.628-10.86 11.336-27.217 12.007-52.99.087-.729.167-1.425.244-2.088l.16-1.362 1.797.158.463.031c10.002.456 22.232-1.665 29.743-5.154 5.935-2.754 24.954-12.795 20.476-26.351' />
      <path
        d='M237.906 160.722c-29.74 6.135-31.785-3.934-31.785-3.934 31.4-46.593 44.527-105.736 33.2-120.211-30.904-39.485-84.399-20.811-85.292-20.327l-.287.052c-5.876-1.22-12.451-1.946-19.842-2.067-13.456-.22-23.664 3.528-31.41 9.402 0 0-95.43-39.314-90.991 49.444.944 18.882 27.064 142.873 58.218 105.422 11.387-13.695 22.39-25.274 22.39-25.274 5.464 3.63 12.006 5.482 18.864 4.817l.533-.452c-.166 1.7-.09 3.363.213 5.332-8.026 8.967-5.667 10.541-21.711 13.844-16.235 3.346-6.698 9.302-.471 10.86 7.549 1.887 25.013 4.561 36.813-11.958l-.47 1.885c3.144 2.519 5.352 16.383 4.982 28.952-.37 12.568-.617 21.197 1.86 27.937 2.479 6.74 4.948 21.905 26.04 17.386 17.623-3.777 26.756-13.564 28.027-29.89.901-11.606 2.942-9.89 3.07-20.267l1.637-4.912c1.887-15.733.3-20.809 11.157-18.448l2.64.232c7.99.363 18.45-1.286 24.589-4.139 13.218-6.134 21.058-16.377 8.024-13.686h.002'
        fill='#336791'
      />
      <path
        d='M108.076 81.525c-2.68-.373-5.107-.028-6.335.902-.69.523-.904 1.129-.962 1.546-.154 1.105.62 2.327 1.096 2.957 1.346 1.784 3.312 3.01 5.258 3.28.282.04.563.058.842.058 3.245 0 6.196-2.527 6.456-4.392.325-2.336-3.066-3.893-6.355-4.35M196.86 81.599c-.256-1.831-3.514-2.353-6.606-1.923-3.088.43-6.082 1.824-5.832 3.659.2 1.427 2.777 3.863 5.827 3.863.258 0 .518-.017.78-.054 2.036-.282 3.53-1.575 4.24-2.32 1.08-1.136 1.706-2.402 1.591-3.225'
        fill='#FFF'
      />
      <path
        d='M247.802 160.025c-1.134-3.429-4.784-4.532-10.848-3.28-18.005 3.716-24.453 1.142-26.57-.417 13.995-21.32 25.508-47.092 31.719-71.137 2.942-11.39 4.567-21.968 4.7-30.59.147-9.463-1.465-16.417-4.789-20.665-13.402-17.125-33.072-26.311-56.882-26.563-16.369-.184-30.199 4.005-32.88 5.183-5.646-1.404-11.801-2.266-18.502-2.376-12.288-.199-22.91 2.743-31.704 8.74-3.82-1.422-13.692-4.811-25.765-6.756-20.872-3.36-37.458-.814-49.294 7.571-14.123 10.006-20.643 27.892-19.38 53.16.425 8.501 5.269 34.653 12.913 59.698 10.062 32.964 21 51.625 32.508 55.464 1.347.449 2.9.763 4.613.763 4.198 0 9.345-1.892 14.7-8.33a529.832 529.832 0 0 1 20.261-22.926c4.524 2.428 9.494 3.784 14.577 3.92.01.133.023.266.035.398a117.66 117.66 0 0 0-2.57 3.175c-3.522 4.471-4.255 5.402-15.592 7.736-3.225.666-11.79 2.431-11.916 8.435-.136 6.56 10.125 9.315 11.294 9.607 4.074 1.02 7.999 1.523 11.742 1.523 9.103 0 17.114-2.992 23.516-8.781-.197 23.386.778 46.43 3.586 53.451 2.3 5.748 7.918 19.795 25.664 19.794 2.604 0 5.47-.303 8.623-.979 18.521-3.97 26.564-12.156 29.675-30.203 1.665-9.645 4.522-32.676 5.866-45.03 2.836.885 6.487 1.29 10.434 1.289 8.232 0 17.731-1.749 23.688-4.514 6.692-3.108 18.768-10.734 16.578-17.36zm-44.106-83.48c-.061 3.647-.563 6.958-1.095 10.414-.573 3.717-1.165 7.56-1.314 12.225-.147 4.54.42 9.26.968 13.825 1.108 9.22 2.245 18.712-2.156 28.078a36.508 36.508 0 0 1-1.95-4.009c-.547-1.326-1.735-3.456-3.38-6.404-6.399-11.476-21.384-38.35-13.713-49.316 2.285-3.264 8.084-6.62 22.64-4.813zm-17.644-61.787c21.334.471 38.21 8.452 50.158 23.72 9.164 11.711-.927 64.998-30.14 110.969a171.33 171.33 0 0 0-.886-1.117l-.37-.462c7.549-12.467 6.073-24.802 4.759-35.738-.54-4.488-1.05-8.727-.92-12.709.134-4.22.692-7.84 1.232-11.34.663-4.313 1.338-8.776 1.152-14.037.139-.552.195-1.204.122-1.978-.475-5.045-6.235-20.144-17.975-33.81-6.422-7.475-15.787-15.84-28.574-21.482 5.5-1.14 13.021-2.203 21.442-2.016zM66.674 175.778c-5.9 7.094-9.974 5.734-11.314 5.288-8.73-2.912-18.86-21.364-27.791-50.624-7.728-25.318-12.244-50.777-12.602-57.916-1.128-22.578 4.345-38.313 16.268-46.769 19.404-13.76 51.306-5.524 64.125-1.347-.184.182-.376.352-.558.537-21.036 21.244-20.537 57.54-20.485 59.759-.002.856.07 2.068.168 3.735.362 6.105 1.036 17.467-.764 30.334-1.672 11.957 2.014 23.66 10.111 32.109a36.275 36.275 0 0 0 2.617 2.468c-3.604 3.86-11.437 12.396-19.775 22.426zm22.479-29.993c-6.526-6.81-9.49-16.282-8.133-25.99 1.9-13.592 1.199-25.43.822-31.79-.053-.89-.1-1.67-.127-2.285 3.073-2.725 17.314-10.355 27.47-8.028 4.634 1.061 7.458 4.217 8.632 9.645 6.076 28.103.804 39.816-3.432 49.229-.873 1.939-1.698 3.772-2.402 5.668l-.546 1.466c-1.382 3.706-2.668 7.152-3.465 10.424-6.938-.02-13.687-2.984-18.819-8.34zm1.065 37.9c-2.026-.506-3.848-1.385-4.917-2.114.893-.42 2.482-.992 5.238-1.56 13.337-2.745 15.397-4.683 19.895-10.394 1.031-1.31 2.2-2.794 3.819-4.602l.002-.002c2.411-2.7 3.514-2.242 5.514-1.412 1.621.67 3.2 2.702 3.84 4.938.303 1.056.643 3.06-.47 4.62-9.396 13.156-23.088 12.987-32.921 10.526zm69.799 64.952c-16.316 3.496-22.093-4.829-25.9-14.346-2.457-6.144-3.665-33.85-2.808-64.447.011-.407-.047-.8-.159-1.17a15.444 15.444 0 0 0-.456-2.162c-1.274-4.452-4.379-8.176-8.104-9.72-1.48-.613-4.196-1.738-7.46-.903.696-2.868 1.903-6.107 3.212-9.614l.549-1.475c.618-1.663 1.394-3.386 2.214-5.21 4.433-9.848 10.504-23.337 3.915-53.81-2.468-11.414-10.71-16.988-23.204-15.693-7.49.775-14.343 3.797-17.761 5.53-.735.372-1.407.732-2.035 1.082.954-11.5 4.558-32.992 18.04-46.59 8.489-8.56 19.794-12.788 33.568-12.56 27.14.444 44.544 14.372 54.366 25.979 8.464 10.001 13.047 20.076 14.876 25.51-13.755-1.399-23.11 1.316-27.852 8.096-10.317 14.748 5.644 43.372 13.315 57.129 1.407 2.521 2.621 4.7 3.003 5.626 2.498 6.054 5.732 10.096 8.093 13.046.724.904 1.426 1.781 1.96 2.547-4.166 1.201-11.649 3.976-10.967 17.847-.55 6.96-4.461 39.546-6.448 51.059-2.623 15.21-8.22 20.875-23.957 24.25zm68.104-77.936c-4.26 1.977-11.389 3.46-18.161 3.779-7.48.35-11.288-.838-12.184-1.569-.42-8.644 2.797-9.547 6.202-10.503.535-.15 1.057-.297 1.561-.473.313.255.656.508 1.032.756 6.012 3.968 16.735 4.396 31.874 1.271l.166-.033c-2.042 1.909-5.536 4.471-10.49 6.772z'
        fill='#FFF'
      />
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
Das [PostgreSQL](https://www.postgresql.org/)-Tool ermöglicht es Ihnen, eine Verbindung zu jeder PostgreSQL-Datenbank herzustellen und eine Vielzahl von Datenbankoperationen direkt innerhalb Ihrer agentischen Workflows durchzuführen. Mit sicherer Verbindungshandhabung und flexibler Konfiguration können Sie Ihre Daten einfach verwalten und mit ihnen interagieren.

Mit dem PostgreSQL-Tool können Sie:

- **Daten abfragen**: Führen Sie SELECT-Abfragen aus, um Daten aus Ihren PostgreSQL-Tabellen mit der `postgresql_query` Operation abzurufen.
- **Datensätze einfügen**: Fügen Sie mit der `postgresql_insert` Operation neue Zeilen zu Ihren Tabellen hinzu, indem Sie die Tabelle und die einzufügenden Daten angeben.
- **Datensätze aktualisieren**: Ändern Sie bestehende Daten in Ihren Tabellen mit der `postgresql_update` Operation, indem Sie die Tabelle, neue Daten und WHERE-Bedingungen angeben.
- **Datensätze löschen**: Entfernen Sie Zeilen aus Ihren Tabellen mit der `postgresql_delete` Operation, indem Sie die Tabelle und WHERE-Bedingungen angeben.
- **Raw SQL ausführen**: Führen Sie beliebige benutzerdefinierte SQL-Befehle mit der `postgresql_execute` Operation für fortgeschrittene Anwendungsfälle aus.

Das PostgreSQL-Tool ist ideal für Szenarien, in denen Ihre Agenten mit strukturierten Daten interagieren müssen – wie z.B. bei der Automatisierung von Berichten, der Synchronisierung von Daten zwischen Systemen oder der Unterstützung datengesteuerter Workflows. Es vereinfacht den Datenbankzugriff und macht es einfach, Ihre PostgreSQL-Daten programmatisch zu lesen, zu schreiben und zu verwalten.
{/* MANUAL-CONTENT-END */}

## Nutzungsanleitung

Integrieren Sie PostgreSQL in den Workflow. Kann Abfragen, Einfügungen, Aktualisierungen, Löschungen und die Ausführung von Raw-SQL durchführen.

## Tools

### `postgresql_query`

Führt eine SELECT-Abfrage auf einer PostgreSQL-Datenbank aus

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `host` | string | Ja | PostgreSQL-Server-Hostname oder IP-Adresse |
| `port` | number | Ja | PostgreSQL-Server-Port \(Standard: 5432\) |
| `database` | string | Ja | Datenbankname für die Verbindung |
| `username` | string | Ja | Datenbank-Benutzername |
| `password` | string | Ja | Datenbank-Passwort |
| `ssl` | string | Nein | SSL-Verbindungsmodus \(disabled, required, preferred\) |
| `query` | string | Ja | SQL SELECT-Abfrage zur Ausführung |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der von der Abfrage zurückgegebenen Zeilen |
| `rowCount` | number | Anzahl der zurückgegebenen Zeilen |

### `postgresql_insert`

Daten in PostgreSQL-Datenbank einfügen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `host` | string | Ja | PostgreSQL-Server-Hostname oder IP-Adresse |
| `port` | number | Ja | PostgreSQL-Server-Port (Standard: 5432) |
| `database` | string | Ja | Name der Datenbank, zu der eine Verbindung hergestellt werden soll |
| `username` | string | Ja | Datenbank-Benutzername |
| `password` | string | Ja | Datenbank-Passwort |
| `ssl` | string | Nein | SSL-Verbindungsmodus (disabled, required, preferred) |
| `table` | string | Ja | Tabellenname, in den Daten eingefügt werden sollen |
| `data` | object | Ja | Datenobjekt zum Einfügen (Schlüssel-Wert-Paare) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Eingefügte Daten (wenn RETURNING-Klausel verwendet wird) |
| `rowCount` | number | Anzahl der eingefügten Zeilen |

### `postgresql_update`

Daten in PostgreSQL-Datenbank aktualisieren

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `host` | string | Ja | PostgreSQL-Server-Hostname oder IP-Adresse |
| `port` | number | Ja | PostgreSQL-Server-Port (Standard: 5432) |
| `database` | string | Ja | Name der Datenbank, zu der eine Verbindung hergestellt werden soll |
| `username` | string | Ja | Datenbank-Benutzername |
| `password` | string | Ja | Datenbank-Passwort |
| `ssl` | string | Nein | SSL-Verbindungsmodus (disabled, required, preferred) |
| `table` | string | Ja | Tabellenname, in dem Daten aktualisiert werden sollen |
| `data` | object | Ja | Datenobjekt mit zu aktualisierenden Feldern (Schlüssel-Wert-Paare) |
| `where` | string | Ja | WHERE-Klausel-Bedingung (ohne WHERE-Schlüsselwort) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Aktualisierte Daten (wenn RETURNING-Klausel verwendet wurde) |
| `rowCount` | number | Anzahl der aktualisierten Zeilen |

### `postgresql_delete`

Daten aus PostgreSQL-Datenbank löschen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `host` | string | Ja | PostgreSQL-Server-Hostname oder IP-Adresse |
| `port` | number | Ja | PostgreSQL-Server-Port (Standard: 5432) |
| `database` | string | Ja | Name der Datenbank, zu der verbunden werden soll |
| `username` | string | Ja | Datenbank-Benutzername |
| `password` | string | Ja | Datenbank-Passwort |
| `ssl` | string | Nein | SSL-Verbindungsmodus (disabled, required, preferred) |
| `table` | string | Ja | Tabellenname, aus der Daten gelöscht werden sollen |
| `where` | string | Ja | WHERE-Klausel-Bedingung (ohne WHERE-Schlüsselwort) |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Gelöschte Daten (wenn RETURNING-Klausel verwendet wurde) |
| `rowCount` | number | Anzahl der gelöschten Zeilen |

### `postgresql_execute`

Rohe SQL-Abfrage auf PostgreSQL-Datenbank ausführen

#### Eingabe

| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `host` | string | Ja | PostgreSQL-Server-Hostname oder IP-Adresse |
| `port` | number | Ja | PostgreSQL-Server-Port (Standard: 5432) |
| `database` | string | Ja | Name der Datenbank, zu der verbunden werden soll |
| `username` | string | Ja | Datenbank-Benutzername |
| `password` | string | Ja | Datenbank-Passwort |
| `ssl` | string | Nein | SSL-Verbindungsmodus (disabled, required, preferred) |
| `query` | string | Ja | Rohe SQL-Abfrage zur Ausführung |

#### Ausgabe

| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Statusmeldung der Operation |
| `rows` | array | Array der von der Abfrage zurückgegebenen Zeilen |
| `rowCount` | number | Anzahl der betroffenen Zeilen |

## Hinweise

- Kategorie: `tools`
- Typ: `postgresql`
